docs: add docs for GtkTreeDragSourceIface
authorWilliam Jon McCann <william.jon.mccann@gmail.com>
Tue, 21 Jan 2014 04:17:34 +0000 (23:17 -0500)
committerWilliam Jon McCann <william.jon.mccann@gmail.com>
Tue, 21 Jan 2014 18:33:45 +0000 (13:33 -0500)
gtk/gtktreednd.h

index ca8152e06e88f564ac56439e980d2b25da1ac581..f55ced714b5661ca33b371e525e1cc3e8096a42e 100644 (file)
@@ -35,10 +35,22 @@ G_BEGIN_DECLS
 typedef struct _GtkTreeDragSource      GtkTreeDragSource; /* Dummy typedef */
 typedef struct _GtkTreeDragSourceIface GtkTreeDragSourceIface;
 
+/**
+ * GtkTreeDragSourceIface:
+ * @row_draggable: Asks the #GtkTreeDragSource whether a particular
+ *    row can be used as the source of a DND operation.
+ * @drag_data_get: Asks the #GtkTreeDragSource to fill in
+ *    selection_data with a representation of the row at path.
+ * @drag_data_delete: Asks the #GtkTreeDragSource to delete the row at
+ *    path, because it was moved somewhere else via drag-and-drop.
+ */
 struct _GtkTreeDragSourceIface
 {
+  /*< private >*/
   GTypeInterface g_iface;
 
+  /*< public >*/
+
   /* VTable - not signals */
 
   gboolean     (* row_draggable)        (GtkTreeDragSource   *drag_source,